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On October 25, APL\360 
anniversary. In the first year 
more than 30,000 terminal hours of 
900 users on the system. 



celebrated its first 

of operation, there were 

use and we now have over 



The normal 
EST. But, when 
later. 



APL\360 schedule is 10:00 a.m. to 9:00 p.m. 
possible, it is kept up until 10:00 p.m. or 



When sending 
expected, use the 
your terminal in 
operator's reply. 



command )0PRN can be used. 



messages to the operator, if a reply is 

system command )0PR., Please then leave 

the locked state and wait for the 

If no reply is required, the system 



APL SYSTEM LIBRARY 



Included in this Issue 
workspace descriptions and 
CLEANSPACE in Library 1. The 
are: 



are two new system library 

a reissued description for 

two new workspace descriptions 



WORKSPACE NAME 



AUTHOR 



APLCOURSE 
TYPE 



A. J. Rose 
A. J. Rose 



The description of CLEANSPACE is being reissued to 
amplify the earlier information and also take into account 
the recently implemented workspace save protective feature. 
The operation of this feature, which prevents a user from 
inadvertently destroying a workspace by saving Information 
into a workspace which has not been loaded, Is given in the 
section on new features. 
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PROGRAMMING HINTS 

The following is an actual sequence of debugging a 
function while executing It for the first time. It 
demonstrates the use of the line-editing facility for making 
insertions, deletions, and changes in a program statement. 

Note that by repeatedly asking for continuation, 
(hy •*■!)» only one execution of the function was necessary. 
It is good practice to use the continuation feature, 
whenever possible, since it saves time and avoids cluttering 
the workspace with the debris of partial function 
executions. Where continuation is not logically feasible, 
branch to zero (->-o) hefore calling the function again. 



VGUESS21U1V 
7 R+GUESS2 A',X;Y 

Cl] R+ZL(+/(.Ao.*A-(X>/<A'. =A)\X+-ipAl 
7 

R+GUESS2 TRY 
SYNTAX ERROR 
GUESS2Lf] R+Zl( + /(A°.ZA-(X>AA°.=A)iX<-\pAl 

A 

VGUESS2L1Q101 
C 1 ] R+Z [ ( + / ( A o . ZA - ( X> AA o . =A ) i X+ \ pA ] 

2 

CI] R--Zl( + /(Ao.ZA-(X>X)AA*.*A)iX+\pAl 

C2] 7 

+1 
RANK ERROR 
GUESS2L11 R+Zl(+/(A°.ZA-(X>X)AAo, =A)\X+\pAl 

A 

VGUESS2Z1U201 
Cl] R+ZL( + /(A°.ZA-(X>X)aA°„ =A)\X+\pAl 

2 

Cl] R+Zl(+/(Ao.zA-(X°.>X)AA°.=A)\Xi-\pAl 
[2] 7 

+1 
RANK ERROR 
GUESS2M R<-ZI(+/(A°.ZA-(Xo.>X)aA°. *A)\X+\pAl 

A 

VGUESS2L1D2H1 
Cl] R<-Zl( + /(Ao.zA-(Xo.>X)AA°.=A)\X<-\pAl 

1 
Cl] R+Zl(+/(A°.ZA)-(X°.>X)AA°. =A)\X+\qA] 
C2] 7 

-+-1 
VALUE ERROR 
GUESS2L11 R+ZI(+/(A<>.ZA)-(X°.>X)aAo. =A)\X+ipAl 

A 

VGUESS2L1U151 
Cl] R+Z[.(+/(Ao.za)-(X°. >X)aAo, *A)\X+\pAl 

/l 
Cl] R+Al( + /(A°.ZA)-( Xo.>X)aAo. =A)iX+ipAl 
C2] 7 

+ 1 



TRY is a vector of numbers, 



Edi ti ng Mode 

Two spaces required 

Insertion of missing 

variable/ parenthesis 
Branch to Line 1 



Edi ti ng Mode 

Two spaces required 

Insertion of missing 

operators 
Branch to Line 1 



Edi ti ng Mode 

One space required 

I nsertion of missi ng 

parenthesi s 
Branch to Line 1 



Edi ti ng Mode 

One deletion, one space 

Insertion of A which 

replaces Z 
Branch to Line 1 
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PROGRAMMING HINTS (Cont.) 



Execution was completed although the result is not shown 
here. Here is the final function definition for you to 
anal yze: 



V R+GUESS2 A;X;Y 
Cl] R+AL( + /{A°.ZA)-(Xo. >X)AA°.=A)\X+\pAl 

V 



It is also a good practice to regularly use the system 
command )A during a dehugging session, to he sure there are 
no suspended functions. This command displays the state 
indicator/ which lists all functions whose execution has not 
been completed. An 8 follows those which are suspended. 
Any function listed without an S cannot be edited until its 
status is changed. The entire stack of unfinished 
executions can be eliminated in two ways: 

1. Branch to zero as many times as there are lines 
indicated by )A. This does not always work and is 
best used when the state indicator is relatively 
short. 

2. Copy the workspace into a clean space, as detailed 
in the description of 1 CLEANSPACE. 

It is almost always the case that 'mysterious' behavior of 
variables is due to the confusion between local and global 
variables of the same name, which occurs when functions with 
local variables are suspended. The procedures given here 
will usually clear this up. 



The last newsletter contained two functions to be 
analyzed - FOODFORTHOUGHT and GUESS. They showed how the 
representation and I-beam functions (1) can be used. As you 
have probably guessed: 

FOODFORTHOUGHT gives the date, formatted with slashes 
between the numbers. 

GUESS gives the time of day. The left argument X 
indicates in which time system you desire to have the 
time of day. The right argument Y is a scalar which 
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Indicates whether you desire hours,, minutes, seconds or 

60th of seconds In a left to right sequence. If Y Is 1, 

hours only would be given. If Y Is 2, hours and 
minutes would be given, etc. 

Following the display of the functions below, there are a 
few examples of actual executions of these functions: 



VFOODFORTHOUGHTl DD V 

V R+-F00DF0RTH0UGHT 
[1] i?+l + (6plO)Tl25 

[2] j?-e'/0123456789'[l + 11011011 \i?] 
V 

VGUESSIU1V 

V R+X GUESS J 

[1] RH HaY)/(X, 60 60 60)Tl20 
V 

R+F00DF0R TEO UGHT 
R 
01/04/68 

F00DF0RTH0UGHT 
01/04/68 

TIME+2H GUESS 3 
TIME 
16 34 34 

2 4 GUESS 2 
16 35 

12 GUESS 3 
4 35 21 



APL PUZZLES 

1. Find an expression for a two-element vector which will 
result in the first element consisting of the Integer 
portion and the second element consisting of the 
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APL PUZZLES (Cont.) 

fractional portion of a positive number. 

2. Determine the result of the following expression: 
(xisascalar) 

These puzzles were contributed by L. M. Breed. 

3. You were asked In the last newsletter to prove the 
equivalence between 

1. M*[N*M and 

2. N+M\-N, 

Starting with 2., and using the relation 
U|3)=i4xl \B*A, we get 

3. N+Mxl\-N*M 
factoring an M from this, we get 

However, It is generally true that 

(A+l\-A)stA 
From which fol lows: 

5. M*[N*M 

NEWLY IMPLEMENTED APL FEATURES 

Since the last newsletter, many APL features have been 
implemented. They include: 

1. Monadic and dyadic transpose. 

2. Change of dieresized characters to underlined 

characters. 

3. Red/black ribbon shift for the 1050 terminals, 
i*. trace. 

5. Stop. 
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NEWLY IMPLEMENTED APL FEATURES (Cont.) 



6. Natural Logarithm. 

7. Reversal. 

8. Protective save feature. 

9. Sign-on with password. 

10. Use of CONTINUE workspace. 

11. Function display from line N. 

12. Use of system command CONTINUE, 

A description of the above features can be obtained by 
)L0AD 1 NEWS and execution of APLNOW 9 12 67. More 

detailed information on some of these features will be given 
in future issues of this newsletter . In this issue, we are 
including a table that shows the behavior of the 
transposition operator. 

MISCELLANEOUS 

We are also including two APL keyboard stickers. v/V 



NOTE: Portions of this newsletter were prepared by using the 
APL text editing programs located In Library 10 under the 
workspace called EDIT. The text editing programs were 
developed by M. Zyrl and A. Mullery. 
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WORKSPACE DESCRIPTION 



Li brary: 

Name: 



APLCOURSE 



The main functions of this library workspace are: 

TEA CH 
EASY DRILL 

All other functions in this workspace are used as subfunctions 
with the main function. They are not self-contained. 



SYNTAX 

TEACH 



DESCRI PTIOM 

A flash card exercise in APL functions usinp 
scalars and vectors. The function prints out the 
choices and options available to the student. 
Examples are selected at random with a random 
starting point/ and three trials are allowed for 
each question. 



EASY DRILL 



MOTE: 

the proper 



This function is the same as TEACH except that the 
problems selected are generally simpler in 
structure. In particular, problems involving 
vectors of length zero or one are excluded. 

For either function, a response of PLEASE will disclose 
A response of STOP will terminate the drill. 



answer. 
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1 

120 

A. J. Rose, IBM Corporation, Thomas J. Watson 

Research Center, P. 0. Box 218, Yorktown Heights, 

New York 10598 
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WORKSPACE DESCRIPTION ' 

Library: 1 

Name: CLE AN SPACE 

The availability of CLEANS PACE- provides a means for making a 
fresh start during the course of a working session. Execution of 
)LOAD l CLEANSPACE replaces the active workspace with one that is 
completely clean. If it is necessary to keep the information 
currently In the active workspace it must be saved prior to 
loading CLEANSPACE- 

Common situations calling for the use of CLEANSPACE, and the 
appropriate sequence of operations are given below. 

To start a new job, or provide a clean slate for assembling 
functions and variables from workspaces already on file in 
libraries/ execute: 

)L0AD 1 CLEANSPACE 
and proceed with the appropriate activity. 

In all other situations, where recovery is not possible by 
simply reloading a copy of the active workspace from the library, 
execute: 



)SAVE 


WSNAME 


)L0AD 1 


CLEANSPACE 


)COPY 


WSNAME 


)DR0P 


WSNAME 


)SAVE 


WSNAME 



If a permanent library copy is not desired, the last )SAVE can be 
omitted, or a shorter sequence using the CONTINUE workspace may 
be used: 

)SAVE CONTINUE 

)L0AD 1 CLEANSPACE 
)COPY CONTINUE 

(In this case there Is the slight risk that If the telephone 
connection is broken between the second and third steps, CONTINUE 
will automatically save a copy of CLEANSPACE) . 

One notable effect of these procedures is that the state 
indicator - displayed by )A - is cleared. 

Situations calling for the use of the SAVE-LOAD-COPY 
sequence are: 

1. To recover from a deeply nested sequence of suspended 
functions, as may result from bugs in a recursive 
arrangement (evidenced by DEPTH ERROR), or simply from 
an accumulation of partially executed functions 
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(evidenced by Inability to edit a function). The depth 
of suspension is measured by px27 , and the functions 
involved can be seen by executing )A. 

2. To recover from a loop involving D or PI. It Is possible 

to execute system commands in a D-condttion/ and one of 
the sequences above can be executed. In the case of 
H, the only recovery is to break the telephone 
connection/ which wi 1 1 cause the automatic execution of 
the equivalent of )SAVE CONTINUE. Then, sign on again 
and proceed with )C0PY CONTINUE' 

3. To maximize the available space in a workspace. Certain 

operations leave internal debris which/ while it does 
not interfere with normal activities, nevertheless uses 
up space which would otherwise be available. Copying a 
workspace deletes the debris. 



FUNCTIONS: NONE 

VARIABLES: NONE 

ORIGIN: 1 

WIDTH: 130 
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WORKSPACE DESCRIPTION 



Library: 

Name: 



1 

TYPE 



MAIN FUNCTION: TYPEDRILL 

All other functions In this workspace are used as subfunctlons. 

SYNTAX DESCRIPTION 



TYPEDRILL 



A timed typing exercise, 
states which can exist: 
state and DRILL state. 



There are three basic 
CONTROL state, ENTRY 



When in the CONTROL state, typing ENTER causes the 
entry state to occur. In this state, you type 
one-line sentences, characters or APL expressions. 
Each typed line then represents a sentence or 
expression in which you wish to be drilled. 
TYPING ONLY A CARRIAGE RETURN CAUSES A RETURN TO 
THE CONTROL STATE. 

Typing DRILL when in the CONTROL state will cause 
the DRILL state to occur. In this state the lines 
you entered in the ENTER state are randomly 
produced one at a time. When a correct entry has 
been made a different line will appear, until each 
line has been presented once. The random cycle 
then begins again. If the line is error-free, the 
time required to type the line is produced. AGAIN, 
TYPING ONLY A CARRIAGE RETURN CAUSES A RETURN TO 
THE CONTROL STATE. 

Typing STAT when in the CONTROL state causes the 
accumulated statistics to be displayed. The 
vertical axis of the display is time in seconds 
and number of errors and the horizontal axis is 
trial numbers. The symbol for time is the star, 
the symbol for error is the circle. A time which 
exceeds the limit of the graph Is denoted by a 
vertical arrow. 

In the example display of statistics shown on the 
following page, there were two exercises: 
'NOW IS THE TIME FOR ALL GOOD MEN 1 and 

'THE QUICK BROWN FOX'. For the first of these, 

response time was ten seconds for the first two 
trials, was greater than ten seconds for the third 
trial, and was nine seconds for the fourth trial. 
There were respectively two, two, and three errors 
on the first three trials before a correct 
response was given. The summary represents number 
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of characters per second averaged over both 
exercises for each cycle. 

Typing STOP when in the CONTROL state causes the 
accumulated statistics to be displayed and 
terminates the exercise. 

STATISTICS 
TIME IN SECONDS (*) AND NUMBER OF ERRORS (o) VS. TRIALS 



'NOW IS THE TIME FOR ALL GOOD MEN' 
** + 



10 
9 
8 
7 
6 
5 
4 
3 
2 
1 



** 

* * 
** * * 
* * 

* * * 
**** ***** *** 

o oo o o 
oo o o 

oo o o o 



L, 



TRIAL: 5 10 15 20 25 
'THE QUICK BROWN FOX' 



9 
8 
7 
6 
5 
4 
3 
2 
1 



* + 
* 
* 
** ** 

** 
** * * * * * 

**** *** ** ** 

o oo 
oo oo o o o o o 



L. 



TRIAL: 5 10 15 20 25 



SUMMARY --CHARACTERS PER SECOND VS TRIALS 



6 
5 

3 
2 

1 



*+ + ■»• + *+ + + * + ** + + 



** * * 
* ** * 



** ** 
* 
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